package cn.song.freight.mapper;

import cn.song.freight.domain.entity.OperationLogDO;
import cn.song.freight.domain.vo.OperationLogStatisticsVO;
import cn.song.freight.domain.vo.OperationStatisticsVO;
import cn.song.freight.domain.vo.OperatorStatisticsVO;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 操作日志数据访问接口
 *
 * @author SongRenShuo
 */
@Mapper
public interface OperationLogMapper extends BaseMapper<OperationLogDO> {

    /**
     * 查询操作日志统计信息
     * 按模块类型和操作类型分组统计
     *
     * @return 统计信息列表
     */
    List<OperationStatisticsVO> selectOperationStatistics();

    /**
     * 查询最近的操作日志
     *
     * @param limit 查询数量限制
     * @return 操作日志列表
     */
    List<OperationLogDO> selectRecentOperations(@Param("limit") Integer limit);

    /**
     * 根据操作人统计操作次数
     *
     * @param days 统计天数
     * @return 统计结果
     */
    List<OperatorStatisticsVO> selectOperationCountByOperator(@Param("days") Integer days);

    /**
     * 清理历史日志
     * 删除指定天数之前的日志记录
     *
     * @param days 保留天数
     * @return 删除的记录数
     */
    Integer deleteHistoryLogs(@Param("days") Integer days);


    /**
     * 查询详细统计信息
     * 包括今日操作、成功操作、失败操作、总操作数
     *
     * @return 详细统计信息
     */
    OperationLogStatisticsVO selectDetailedStatistics();
}
